home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / bbox2.z / bbox2
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbbbbbooooxxxx2222((((3333GGGG))))                                                            bbbbbbbbooooxxxx2222((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbbbbbooooxxxx2222,,,, bbbbbbbbooooxxxx2222iiii,,,, bbbbbbbbooooxxxx2222ssss - culls and prunes to bounding box and minimum
  10.      pixel radius
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd bbbbbbbbooooxxxx2222((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  14.      SSSSccccrrrreeeeeeeennnnccccoooooooorrrrdddd xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn;;;;
  15.      CCCCoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  16.  
  17.      vvvvooooiiiidddd bbbbbbbbooooxxxx2222iiii((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  18.      SSSSccccrrrreeeeeeeennnnccccoooooooorrrrdddd xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn;;;;
  19.      IIIIccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  20.  
  21.      vvvvooooiiiidddd bbbbbbbbooooxxxx2222ssss((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  22.      SSSSccccrrrreeeeeeeennnnccccoooooooorrrrdddd xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn;;;;
  23.      SSSSccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  24.  
  25.      All of the above routines are functionally the same.  They differ only in
  26.      the declaration types of their parameters.
  27.  
  28. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  29.      _x_m_i_n   expects the width, in pixels, of the smallest displayable feature.
  30.  
  31.      _y_m_i_n   expects the height, in pixels, of the smallest displayable
  32.             feature.
  33.  
  34.      _x_1     expects the _x coordinate of a corner of the bounding box.
  35.  
  36.      _y_1     expects the _y coordinate of a corner of the bounding box.
  37.  
  38.      _x_2     expects the _x coordinate of a corner of the bounding box. The
  39.             corner referenced by this parameter must be diagonally opposite
  40.             the corner referenced by the _x_1 and  _y_1 parameters.
  41.  
  42.      _y_2     expects the _y coordinate of a corner of the bounding box. The
  43.             corner referenced by this parameter must be diagonally opposite
  44.             the corner referenced by the _x_1 and  _y_1 parameters.
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      bbbbbbbbooooxxxx2222 performs the graphical functions known as _c_u_l_l_i_n_g and _p_r_u_n_i_n_g.
  48.      Culling prevents the system from drawing objects that are less than the
  49.      minimum feature size (_x_m_i_n and _y_m_i_n). Pruning prevents the system from
  50.      drawing objects that lie completely outside the viewport.
  51.  
  52.      To determine whether or not to cull an object, bbbbbbbbooooxxxx2222 tests whether or not
  53.      the display of a rectangle the size of the bounding box is smaller than
  54.      the minimum feature size. To determine whether or not to prune an object,
  55.      bbbbbbbbooooxxxx2222 tests whether or not the bounding box is completely outside the
  56.      viewport.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbbbbbooooxxxx2222((((3333GGGG))))                                                            bbbbbbbbooooxxxx2222((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Call bbbbbbbbooooxxxx2222 within the definition for an object, just after the call to
  75.      mmmmaaaakkkkeeeeoooobbbbjjjj.  If the object must be pruned or culled, the remainder of the
  76.      object definition is ignored.
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      makeobj
  80.  
  81. NNNNOOOOTTTTEEEESSSS
  82.      This routine does not function in immediate mode.
  83.  
  84.      This routine is not a free test.  If you use bbbbbbbbooooxxxx2222 too freely, your
  85.      performance can suffer.  Reserve bbbbbbbbooooxxxx2222 for complicated object definitions
  86.      only.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.